Skip to main content

Primary Sales

Create a Primary Sale​

Here are the steps to request a Primary Sale on Open Loot.

  1. Go to "Sales" > "Primary Sales"
  2. Here you will see a list of all your past primary sales. You can click on any of them to view more details for that sale. To request a new primary sale, click on "Create New Sale" in the upper right.
  3. Fill out the details for the primary sale, then click on "Create".
    • Name: This is the display name of the sale.
    • Sale Start Time (UTC): This is the start time of the sale group as a whole. Keep in mind that each individual sale item will have their own start times as well.
    • Description: This is the text description to be displayed on the sale page.
    • Sale Banner Upload (Desktop): This is the banner image that will be displayed at the top of the sale group page on desktop browsers. Images should be in .png format, and be 1362 px (width) x 216 px (height).
    • Sale Banner Upload (Mobile): This is the banner image that will be displayed at the top of the sale group page on mobile browsers. Images should be in .png format, and be 355 px (width) x 234 px (height)
  4. Once you've created the sale, you will be shown the details you submitted for the sale group, as well as a few other items:
    • Approval Status: At the start, your sale will be "Not Yet Submitted". Once submitted and approved, this will change to "Completed".
    • Slug: This represents the string that will make up the URL for the sae page.
    • Status: By default your sale will be disabled. Switch to enabled to make the page visible. You will not be able to do this on production until the sale has been approved.
    • Edit Sale Details: This will allow you to edit specific details of the sale group, including the slug.
    • Items: This will allow you to add individual sale items to your sale group.
    • Submit for Approval: Click this once your sale is ready for review. You will be unable to make edits to your sale while it is under review. You can also choose to cancel your submission if you want to make edits.

Adding Sale Items​

As sale group can be made up of multiple sale items, each with it's own NFT, pricing, start time, sale parameters, etc. For a created sale group, start by clicking on "Add Item".

  1. Add Sale Item
    • Name: This is the display name of the sale item. It often times should match the name of the NFT item, but it doesn't have to.
    • Description: This is the display description of the sale item. It often times should match the description of the NFT item, but it doesn't have to.
    • Price: This is the price in USD of the NFT item.
    • Option Name: This is the option_name of the NFT item to be sold.
    • Sale Quantity: This is the number of issues of this NFT item that are available for sale. This value cannot be greater than the current amount of unowned issues for this item.
      • Once the sale item has been created with a specified Sale Quantity, that amount of items will be reserved for this sale. If you want to release the items from this sale, the sale item first must be disabled. You cannot release items while the sale is active.
    • Limit per User: This is the maximum number of issues a user can buy from this particular sale.
    • Limit per Transaction: This is the maximum number of issues a user can buy from a single transaction.
    • Sale Start Time (UTC): This is the time this sale item will become available to purchase. The countdown display will be counting down to this time and date.
    • Sale End Time (UTC): This is the time this sale item becomes no longer available for purchase, regardless of how many issues have sold.
    • Status: This controls the visibility of the sale item on the sale group page.
  2. Whitelist
    • Disabled/Enabled: By default this is disabled. To apply a whitelist to this sale item, set this to enabled. The whitelist feature allows you to make this sale item only available to a specific list of users, for a set amount of time before it is opened to the public.
    • Ending Conditions
      • Whitelist Quantity: This is the amount out of the Sale Quantity that are held just for whitelisted users. Once this amount has sold, then the whitelist is no longer applied, and any user can participate in the sale.
      • Expires at (UTC): This is the time and date after which the whitelist will no longer be applied.
      • The whitelist phase will end whenever at least one of these conditions is met.
    • Limit per User: This is the maximum number of issues a whitelisted user can buy from this particular sale during the whitelist phase. This amount is counted towards the value of Limit per User for the public.
    • Limit per Transaction: This is the maximum number of issues a whitelisted user can buy from a single transaction during the whitelist phase.
    • CSV: Download the CSV template to see an example of a whitelist. The whitelist will accept email, username, and userid. Upload the whitelist here, and then you can click on "View Whitelist" to view the currently uploaded list.
  3. Create: Click on this when you are finished filling out the details of the sale item.

Approvals​

Sale requests on Sandbox do not require any approvals. Sale requests on Production will require the approval of the Open Loot Admin. Your Sale request will start out in the "Awaiting Approval" state, until your Open Loot Admin has reviewed the request and approved it. Once approved, the Sale will be created.